home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / BACKUP / QDEL033.ZIP;1 / QDEL.DOC next >
Encoding:
Text File  |  1993-11-11  |  10.5 KB  |  278 lines
  1.  
  2.  
  3.                 QDEL version 0.33 Instruction Manual
  4.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6.                      (C) Konrad Budych 1991-93
  7.  
  8.  
  9.  
  10.         What is QDEL ?
  11.         ~~~~~~~~~~~~~~
  12.  
  13.     QDEL is the program which deletes all files and sub-directories starting
  14. from the specified directory (or directories).  It may skip specified
  15. sub-directories and/or leave files in specified sub-directories intact.  It
  16. may show you the number of directories deleted, amount of disk space freed,
  17. and time of the activity.  It is extremely easy to use and configure.
  18.  
  19.     Starting from version 0.30 QDEL is almost as fast as 'DEL *.*' and much
  20. faster than ever before!  This can be noticed when QDELing diskettes --- in
  21. some tests QDEL v0.30 was 30 times faster then QDEL v0.22 and all other
  22. programs that use find-one-delete-one scheme!  This is because QDEL now uses
  23. obsolete, but very fast Delete-via-FCB DOS function.
  24.  
  25.     QDEL does not ask any questions by default.  This can be changed with
  26. switch 'P' (one question for each tree to be deleted) or 'p' (two question for
  27. (almost) each directory in each tree to be deleted).  See below for details.
  28. QDEL cannot remove current or root directory of any drive.  This cannot be
  29. changed.
  30.  
  31.     QDEL removes *all* files including read-only, hidden, and system files.
  32. No warning is given when deleting these files.  Also no filename mask may be
  33. specified, '*.*' is always used.  So please be careful --- the command 'QDEL
  34. C:\' will delete ALL your files on drive C: (including system files) without
  35. any prompt.
  36.  
  37.     QDEL is ideal tool if you want to delete an application which is located
  38. in many subdirectories of a directory, clear a ramdisk or diskette very fast.
  39.  
  40.     QDEL is a game of some kind --- the more you delete the more points you
  41. get!  See below for details.
  42.  
  43.     Keep this program away from babies and children!  It may be dangerous.
  44. You have been warned.
  45.  
  46.     And have fun using this program!
  47.  
  48.  
  49.  
  50.         How to use it ?
  51.         ~~~~~~~~~~~~~~~
  52.  
  53.     To install QDEL, copy QDEL.EXE to a directory listed in your PATH.
  54.  
  55.     Use QDEL as follows:
  56.  
  57.                 QDEL [switches] dir [dir...]
  58.  
  59. 'dir'
  60.     This is a directory name like 'A:\', '.', 'D:..', 'C:\OLD', and so on.  A
  61.     '\' at the end of 'dir' is not allowed unless it means root directory.
  62.  
  63. 'switches'
  64.     Switches can be placed anywhere in command line, but they are effective
  65.     from the place they occur.  They cannot be joined together.  They can be
  66.     followed by '+' or '-' to set explicitly their value, otherwise their
  67.     state is toggled each time they are used.  See below for detailed
  68.     description of all switches.
  69.  
  70.  
  71.  
  72.         Switches description
  73.         ~~~~~~~~~~~~~~~~~~~~
  74.  
  75.     Switches may be placed anywhere in command line but they are active from
  76. the place they occur.  There are three possible uses of each switch: '-x'
  77. toggles state of a switch, '-x-' turns a switch off, and '-x+' turns a switch
  78. on.  Most switches are off by default unless you turn them on in QDEL variable
  79. (see next section).
  80.  
  81.     You may precede switches with either '-' or '/'.
  82.  
  83.     Here is a detailed description of all switches.
  84.  
  85. '?' - help screen
  86.     This displays help screen.  'QDEL A:\ /?' works as expected --- first
  87.     clears A: then displays help screen.  But 'QDEL /? A:' works the same way
  88.     --- help screen is always displayed after everything else is done.  Help
  89.     screen is not displayed if either 'q' or 'Q' is on.
  90.  
  91. '-' - disable a '-' as switch prefix
  92.     Use this if you want to delete a directory with the name beginning with a
  93.     '-' (eg.  'QDEL -- -DIR-') or if you always use '/' to precede switches.
  94.  
  95. 'P' - prompt before processing each given directory
  96.     QDEL will ask one question before processing each directory you specify
  97.     in command line:
  98.  
  99.             "Dir DIRECTORY to be cleared. Are you sure (Y/N/Q)?"
  100.  
  101.     If you answer <N> nothing happens to your disk.  This switch is good for
  102.     beginners.  Pressing <Q> or <ESC> aborts QDEL.
  103.  
  104. 'p' - prompt before processing each directory in tree
  105.     QDEL will ask two question before processing any directory in tree:
  106.  
  107.             "Proceed to DIRECTORY (Y/N/F/Q)?"    and
  108.             "Delete files in DIRECTORY (Y/N/Q)?"
  109.  
  110.     If you answer <F> ('Fast') for the first question, QDEL will automatically
  111.     proceed to all DIRECTORY's sub-directories and will not ask the second
  112.     question assuming 'Yes'.  <ESC> or <Q> quits in all cases.  Answers <Y>
  113.     and <N> do expected things.  This switch is very annoying.
  114.  
  115. 'q' and 'Q' - quiet work modes
  116.     If 'q' is on, QDEL will display only prompts, and errors.  If 'Q' is on,
  117.     QDEL will display only prompts, and statistics.  Prompts are displayed
  118.     only if 'p' is on.  Use both 'q' and 'Q' and turn 'p' off for no messages
  119.     (in batch mode for example).
  120.  
  121. 'e' - abort on first error
  122.     Normally QDEL ignores all errors (displays messages and goes on).  If this
  123.     switch is on, QDEL will abort after first error occurs.  Many QDEL-like
  124.     programs act that way.
  125.  
  126. 'r' - repeated deleting
  127.     This switch when active causes QDEL to repeating processing each directory
  128.     given as parameter if a user wishes to do it.  In detail: after a
  129.     directory tree deleting is finished QDEL asks a question like:
  130.  
  131.             "Repeat deleting DIRECTORY (Y/N/Q)?"
  132.  
  133.     This can have one no-nonsense purpose: clearing a lot of diskettes --- you
  134.     just change them when QDEL asks and press <Y>.
  135.  
  136. 'f' - report free space left on disk
  137.     This switch is on by default.  QDEL displays the amount of the free disk
  138.     space left.
  139.  
  140. 's' - statistics and more...
  141.     This switch is on by default.  It makes QDEL display a number of
  142.     directories processed, amount of disk space freed, activity time, and
  143.     scores.  Directories processed with 's' off are not counted.
  144.  
  145.     Amount of disk space freed is calculated as follows: before and after
  146.     processing a directory QDEL finds disk free space.  They are subtracted
  147.     and this is the result.  It may be inaccurate or even false on network
  148.     drives and/or in multitasking environments.
  149.  
  150.     If 'p' or 'P' is on the idle time (waiting for key press) is also
  151.     displayed.
  152.  
  153.     You get 1 point for each 4 kB of disk space freed, 20 points for each
  154.     directory removed.  Bonus: 5 point for each read-only file, 10 points
  155.     extra for each directory, if you deleted more than 40 of them, and 1 point
  156.     extra for each 2 kB of disk space freed, if more than 4 MB was freed.
  157.     This is very useful to estimate the results of QDEL's work.
  158.  
  159.     Unfortunately high scores are not stored.
  160.  
  161.     You may disable this switch to spped up QDEL's work slightly.
  162.  
  163.  
  164.  
  165.         Configuring QDEL
  166.         ~~~~~~~~~~~~~~~~
  167.  
  168.     If you wish always start QDEL with certain switches, put them in QDEL
  169. environment variable using SET command.  These switches will be read before
  170. any command line parameters.  For example, you may want to add this to your
  171. AUTOEXEC.BAT.
  172.  
  173.                 SET QDEL=-P -e -s-
  174.  
  175.     Switches must not be joined together, as usually.
  176.  
  177.  
  178.  
  179.         Examples
  180.         ~~~~~~~~
  181.  
  182. QDEL -p+ C:\
  183.     You will be asked what to delete on drive C:.
  184.  
  185. QDEL -Q A:\
  186.     Clears diskette quietly, show statistics and nothing more.
  187.  
  188. QDEL -Q -q -s A:\ B:\
  189.     Clear two diskettes very quietly: no screen output.
  190.  
  191. QDEL . -p
  192.     Delete ALL in current directory and deeper WITHOUT prompts.  '-p' has NO
  193.     effect --- it is turned on after '.' is cleared.
  194.  
  195. QDEL -q . -q
  196.     Same as above, print errors and statistics only.
  197.  
  198. QDEL -r A:\
  199.     Clear a box (or two, or ten) of diskettes.
  200.  
  201. SET QDEL=-s- -f- -P
  202.     No statistics and confirmation required by default.  'Ok.' will be printed
  203.     after work is done.
  204.  
  205.     There will be more examples in the next version of QDEL.DOC.
  206.  
  207.  
  208.  
  209.         Where to buy
  210.         ~~~~~~~~~~~~
  211.  
  212.     Nowhere.  QDEL is free.  You may give it away to friends and enemies.  But
  213. you are not permitted to sell or modify it.  If you distribute QDEL, please
  214. distribute original, unmodified archive file.
  215.  
  216.     If you think this program is great, please send something to the author
  217. (money, diskettes, postcards, your programs, etc.).  You can contact the
  218. author via e-mail or via snail mail using the following addresses:
  219.  
  220.         Konrad Budych                    Internet address:
  221.         os.Boh.Wrzesnia 24/67                kbudych@ii.uj.edu.pl
  222.         31-621 Krakow, Poland
  223.  
  224.     Very strange things often happen to ii.uj.edu.pl host so do not give up
  225. easily when you get no answer!
  226.  
  227.  
  228.  
  229.         Disclaimer
  230.         ~~~~~~~~~~
  231.  
  232.     QDEL is supplied as is.  The author disclaims all warranties, expressed or
  233. implied, including, without limitation, the warranties of merchantability and
  234. of fitness for any purpose.  The author assumes no liability for any damages,
  235. direct or consequential, which may result from the use of, or inability to use
  236. QDEL.
  237.  
  238.  
  239.  
  240.         Revision history
  241.         ~~~~~~~~~~~~~~~~
  242.  
  243. 0.33    'r' and 'f' switches added
  244.         Some messages and prompts changed.
  245.         More info displayed.
  246.         Write protected disk now detected.
  247.         A couple of minor changes.
  248. 0.32:   'P' switch added.
  249. 0.31:   Test-only version. Never released.
  250.         'Q' and 'q' bug fixed and meaning changed.
  251.         Activity time added to statistics.
  252.         'e' switch added, 's' switch changed.
  253.         DOS critical error handler added.
  254.         Documentation and messages modified.
  255. 0.30:   Fast '*.*' deleting.
  256.         New statistics and scores; bonuses added.
  257.         'N', 'Y', 'S' switches removed; 's' now on by default.
  258.         New command line scanning procedure.
  259.         Documentation and messages modified.
  260.         Version number increased by 0.08 because of many changes.
  261. 0.22:   '-' switch added.
  262.         New command line scanning procedure.
  263.         Some messages changed.
  264. 0.21:   's' and 'S' switch added.
  265.         Scores added.
  266.         Documentation rewritten.
  267. 0.20:   First version of Second Edition of QDEL.
  268.         Rewritten from Turbo Pascal to Turbo C++.
  269.         Oldest switches ('?', 'q', 'Q', 'p', 'Y', and 'N') added.
  270.         Multiple directories allowed.
  271.         256-characters-long paths added (for Novell NetWare volumes).
  272.         Cosmetic changes.
  273.         Version number incresed by 0.12 because of many changes.
  274. 0.08:   Released within QKit 1.00.
  275.         Documented for the first time.
  276. 0.0x:   Minor cosmetic changes, no severe bugs found.
  277. 0.01:   First release of QDEL: no switches, one directory allowed.
  278.